TextIter.forwardSearch

Searches forward for @str.

Any match is returned by setting @match_start to the first character of the match and @match_end to the first character after the match. The search will not continue past @limit. Note that a search is a linear or O(n) operation, so you may wish to use @limit to avoid locking up your UI on large buffers.

@match_start will never be set to a GtkTextIter located before @iter, even if there is a possible @match_end after or at @iter.

class TextIter
bool
forwardSearch

Parameters

str string

a search string

flags GtkTextSearchFlags

flags affecting how the search is done

matchStart TextIter

return location for start of match

matchEnd TextIter

return location for end of match

limit TextIter

location of last possible @match_end, or %NULL for the end of the buffer

Return Value

Type: bool

whether a match was found

Meta